home *** CD-ROM | disk | FTP | other *** search
SSSSNNNNRRRRMMMM2222((((3333SSSS)))) SSSSNNNNRRRRMMMM2222((((3333SSSS)))) NNNNAAAAMMMMEEEE SSSSNNNNRRRRMMMM2222, DDDDNNNNRRRRMMMM2222, SSSSCCCCNNNNRRRRMMMM2222, DDDDZZZZNNNNRRRRMMMM2222 - Computes the Euclidean norm of a vector SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS Single precision Fortran: rrrreeeeaaaallll SSSSNNNNRRRRMMMM2222 rrrreeeeaaaallll _e_n_r_m _e_n_r_m ==== SSSSNNNNRRRRMMMM2222 ((((_n,,,, _x,,,, _i_n_c_x)))) C/C++: ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>> ffffllllooooaaaatttt ssssnnnnrrrrmmmm2222 ((((iiiinnnntttt _n,,,, ffffllllooooaaaatttt *_x,,,, iiiinnnntttt _i_n_c_x))));;;; Double precision Fortran: ddddoooouuuubbbblllleeee pppprrrreeeecccciiiissssiiiioooonnnn DDDDNNNNRRRRMMMM2222 ddddoooouuuubbbblllleeee pppprrrreeeecccciiiissssiiiioooonnnn _e_n_r_m _e_n_r_m ==== DDDDNNNNRRRRMMMM2222 ((((_n,,,, _x_i,,,, _i_n_c_x)))) C/C++: ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>> ddddoooouuuubbbblllleeee ddddnnnnrrrrmmmm2222 ((((iiiinnnntttt _n,,,, ddddoooouuuubbbblllleeee *_x,,,, iiiinnnntttt _i_n_c_x))));;;; Single precision complex Fortran: rrrreeeeaaaallll SSSSCCCCNNNNRRRRMMMM2222 rrrreeeeaaaallll _e_n_r_m _e_n_r_m ==== SSSSCCCCNNNNRRRRMMMM2222 ((((_n,,,, _x,,,, _i_n_c_x)))) C/C++: ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>> ffffllllooooaaaatttt ssssccccnnnnrrrrmmmm2222 ((((iiiinnnntttt _n,,,, ssssccccssssllll____ccccoooommmmpppplllleeeexxxx *_x,,,, iiiinnnntttt _i_n_c_x))));;;; C++ STL: ####iiiinnnncccclllluuuuddddeeee <<<<ccccoooommmmpppplllleeeexxxx....hhhh>>>> ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>> ffffllllooooaaaatttt ssssccccnnnnrrrrmmmm2222 ((((iiiinnnntttt _n,,,, ccccoooommmmpppplllleeeexxxx<<<<ffffllllooooaaaatttt>>>> *_x,,,, iiiinnnntttt _i_n_c_x))));;;; Double precision complex Fortran: ddddoooouuuubbbblllleeee pppprrrreeeecccciiiissssiiiioooonnnn DDDDZZZZNNNNRRRRMMMM2222 ddddoooouuuubbbblllleeee pppprrrreeeecccciiiissssiiiioooonnnn _e_n_r_m _e_n_r_m ==== DDDDZZZZNNNNRRRRMMMM2222 ((((_n,,,, _x_i,,,, _i_n_c_x)))) C/C++: ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>> ddddoooouuuubbbblllleeee ddddzzzznnnnrrrrmmmm2222 ((((iiiinnnntttt _n,,,, ssssccccssssllll____zzzzoooommmmpppplllleeeexxxx *_x,,,, iiiinnnntttt _i_n_c_x))));;;; PPPPaaaaggggeeee 1111 SSSSNNNNRRRRMMMM2222((((3333SSSS)))) SSSSNNNNRRRRMMMM2222((((3333SSSS)))) C++ STL: ####iiiinnnncccclllluuuuddddeeee <<<<ccccoooommmmpppplllleeeexxxx....hhhh>>>> ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>> ddddoooouuuubbbblllleeee ddddzzzznnnnrrrrmmmm2222 ((((iiiinnnntttt _n,,,, ccccoooommmmpppplllleeeexxxx<<<<ddddoooouuuubbbblllleeee>>>> *_x,,,, iiiinnnntttt _i_n_c_x))));;;; IIIIMMMMPPPPLLLLEEEEMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN These routines are part of the SCSL Scientific Library and can be loaded using either the ----llllssssccccssss or the ----llllssssccccssss____mmmmpppp option. The ----llllssssccccssss____mmmmpppp option directs the linker to use the multi-processor version of the library. When linking to SCSL with ----llllssssccccssss or ----llllssssccccssss____mmmmpppp, the default integer size is 4 bytes (32 bits). Another version of SCSL is available in which integers are 8 bytes (64 bits). This version allows the user access to larger memory sizes and helps when porting legacy Cray codes. It can be loaded by using the ----llllssssccccssss____iiii8888 option or the ----llllssssccccssss____iiii8888____mmmmpppp option. A program may use only one of the two versions; 4-byte integer and 8-byte integer library calls cannot be mixed. The C and C++ prototypes shown above are appropriate for the 4-byte integer version of SCSL. When using the 8-byte integer version, the variables of type iiiinnnntttt become lllloooonnnngggg lllloooonnnngggg and the <<<<ssssccccssssllll____bbbbllllaaaassss____iiii8888....hhhh>>>> header file should be included. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN SSSSNNNNRRRRMMMM2222/DDDDNNNNRRRRMMMM2222 computes the Euclidean (_l_2) norm of a real vector, as follows: enrm <- ||x|| = 2 T n 2 sqrt (x x) = sqrt (Sum * x ) i=1 i where _x is a real vector, and _x_T denotes the transpose of _x. SSSSCCCCNNNNRRRRMMMM2222/DDDDZZZZNNNNRRRRMMMM2222 computes the Euclidean (_l_2) norm of a complex vector, as follows: enrm <- ||x|| = 2 H n _ sqrt (x x) = sqrt (Sum x x ) i=1 i i where _x is a complex vector, and _x_H denotes the conjugate transpose of _x. PPPPaaaaggggeeee 2222 SSSSNNNNRRRRMMMM2222((((3333SSSS)))) SSSSNNNNRRRRMMMM2222((((3333SSSS)))) See the NOTES section of this man page for information about the interpretation of the data types described in the following arguments. These functions have the following arguments: _e_n_r_m Result. (output) SSSSNNNNRRRRMMMM2222: Single precision result. DDDDNNNNRRRRMMMM2222: Double precision result. SSSSCCCCNNNNRRRRMMMM2222: Single precision complex result. DDDDZZZZNNNNRRRRMMMM2222: Double precision complex result. Result (Euclidean norm). If _n <= 0, _e_n_r_m is set to 0. _n Integer. (input) Number of elements in the operand vector. _x Array of dimension (_n-1) * |_i_n_c_x| + 1. (input) SSSSNNNNRRRRMMMM2222: Single precision array. DDDDNNNNRRRRMMMM2222: Double precision array. SSSSCCCCNNNNRRRRMMMM2222: Single precision complex array. DDDDZZZZNNNNRRRRMMMM2222: Double precision complex array. Array _x contains the operand vector. _i_n_c_x Integer. (input) Increment between elements of _x. If _i_n_c_x = 0, the results will be unpredictable. NNNNOOOOTTTTEEEESSSS These routines are Level 1 Basic Linear Algebra Subprograms (Level 1 BLAS). When working backward (_i_n_c_x < 0), each routine starts at the end of the vector and moves backward, as follows: _x(1-_i_n_c_x * (_n-1)), _x(1-_i_n_c_x * (_n-2)), ..., _x(1) DDDDaaaattttaaaa TTTTyyyyppppeeeessss The following data types are described in this documentation: TTTTeeeerrrrmmmm UUUUsssseeeedddd DDDDaaaattttaaaa ttttyyyyppppeeee Fortran: Array dimensioned _n xxxx((((nnnn)))) Integer IIIINNNNTTTTEEEEGGGGEEEERRRR (IIIINNNNTTTTEEEEGGGGEEEERRRR****8888 for ----llllssssccccssss____iiii8888[[[[____mmmmpppp]]]]) Single precision RRRREEEEAAAALLLL Double precision DDDDOOOOUUUUBBBBLLLLEEEE PPPPRRRREEEECCCCIIIISSSSIIIIOOOONNNN PPPPaaaaggggeeee 3333 SSSSNNNNRRRRMMMM2222((((3333SSSS)))) SSSSNNNNRRRRMMMM2222((((3333SSSS)))) Single precision complex CCCCOOOOMMMMPPPPLLLLEEEEXXXX Double precision complex DDDDOOOOUUUUBBBBLLLLEEEE CCCCOOOOMMMMPPPPLLLLEEEEXXXX C/C++: Array dimensioned _n xxxx[[[[_n]]]] Integer iiiinnnntttt (lllloooonnnngggg lllloooonnnngggg for ----llllssssccccssss____iiii8888[[[[____mmmmpppp]]]]) Single precision ffffllllooooaaaatttt Double precision ddddoooouuuubbbblllleeee Single precision complex ssssccccssssllll____ccccoooommmmpppplllleeeexxxx Double precision complex ssssccccssssllll____zzzzoooommmmpppplllleeeexxxx C++ STL: Array dimensioned _n xxxx[[[[_n]]]] Integer iiiinnnntttt (lllloooonnnngggg lllloooonnnngggg for ----llllssssccccssss____iiii8888[[[[____mmmmpppp]]]]) Single precision ffffllllooooaaaatttt Double precision ddddoooouuuubbbblllleeee Single precision complex ccccoooommmmpppplllleeeexxxx<<<<ffffllllooooaaaatttt>>>> Double precision complex ccccoooommmmpppplllleeeexxxx<<<<ddddoooouuuubbbblllleeee>>>> SSSSEEEEEEEE AAAALLLLSSSSOOOO IIIINNNNTTTTRRRROOOO____SSSSCCCCSSSSLLLL(3S), IIIINNNNTTTTRRRROOOO____BBBBLLLLAAAASSSS1111(3S) IIIINNNNTTTTRRRROOOO____CCCCBBBBLLLLAAAASSSS(3S) for information about using the C interface to Fortran 77 Basic Linear Algebra Subprograms (legacy BLAS) set forth by the Basic Linear Algebra Subprograms Technical Forum. PPPPaaaaggggeeee 4444 
